<html>
<head>
<META HTTP-EQUIV="Content-Type" content="text/html; charset=UTF-8">
<title>实用工具组件包 - COM组件参考</title>
<link rel="stylesheet" type="text/css" href="comdoc.css"/>
</head>
<body>
<h1>Discoverx2.Shell</h1>
<h2>常用外壳工具组件</h2>
<hr/>
<h3>方法:</h3>
<table class="comobjmembers" cellspacing="0" cellpadding="2">
<colgroup><col width="30%"/><col width=""/></colgroup>
<tr class="head"><td>方法签名</td><td>方法说明</td></tr>
<tr class="memberitemodd"><td>GetSystemFolder<div class="methodparam">返回:文本</div></td><td>返回Windows系统目录（System32目录）</td></tr>
<tr class="memberitemeven"><td>GetWorkFolder<div class="methodparam">参数1:szSubFolder(文本),默认值:</div><div class="methodparam">返回:文本</div></td><td>返回工作目录，如果没有则创建，szSubFolder可以指定子目录，默认（不提供）为工作目录根地址。</td></tr>
<tr class="memberitemodd"><td>GetWorkFolderTemp<div class="methodparam">返回:文本</div></td><td>返回工作目录下的临时目录，如果没有则创建，一般用于保存临时文件。</td></tr>
<tr class="memberitemeven"><td>GetWindowsVersionString<div class="methodparam">返回:文本</div></td><td>返回Windows版本号，格式为：主版本号.次版本号.创建号</td></tr>
<tr class="memberitemodd"><td>GetFileVersionString<div class="methodparam">参数1:szFile(文本)</div><div class="methodparam">返回:文本</div></td><td>返回文件版本号，格式为：主版本号.次版本号.创建号</td></tr>
<tr class="memberitemeven"><td>GetWindowsUserName<div class="methodparam">返回:文本</div></td><td>返回Windows当前登录用户名</td></tr>
<tr class="memberitemodd"><td>GetPersonalFolder<div class="methodparam">返回:文本</div></td><td>返回当前用户的“我的文档”对应的磁盘目录</td></tr>
<tr class="memberitemeven"><td>GetFileLength<div class="methodparam">参数1:szFilePath(文本)</div><div class="methodparam">返回:无符号整数</div></td><td>获取指定文件名的文件大小，如果文件不存在则显示错误并返回0。</td></tr>
<tr class="memberitemodd"><td>GetInstallPath<div class="methodparam">返回:文本</div></td><td>返回组件的安装目录。</td></tr>
<tr class="memberitemeven"><td>ClearTempWorkFolder</td><td>删除临时工作目录下的所有文件。</td></tr>
<tr class="memberitemodd"><td>DeleteTempFile<div class="methodparam">参数1:szFileName(文本)</div><div class="methodparam">返回:布尔</div></td><td>删除临时目录下的指定文件（可用通配符），返回true或者false指示是否删除成功。</td></tr>
<tr class="memberitemeven"><td>FileExists<div class="methodparam">参数1:szFilePath(文本)</div><div class="methodparam">返回:布尔</div></td><td>检查指定文件是否存在。</td></tr>
<tr class="memberitemodd"><td>LaunchFile<div class="methodparam">参数1:szFilePath(文本)</div><div class="methodparam">参数2:szVerb(文本),默认值:open</div><div class="methodparam">参数3:blWait(布尔),默认值:0</div><div class="methodparam">返回:布尔</div></td><td>根据传入的文件名打开（编辑、浏览）文件，szVerb参数接收“open”、“edit”等动作字符串，不支持可执行文件，blWait表示是否等待打开的程序结束，默认为不等待，打开成功则返回true。</td></tr>
<tr class="memberitemeven"><td>FindAssocProgram<div class="methodparam">参数1:szFilePath(文本)</div><div class="methodparam">参数2:szVerb(文本),默认值:open</div><div class="methodparam">返回:文本</div></td><td>根据文件名(szFilePath)中的扩展名查找对文档执行指定动作(szVerb)的可执行文件并返回其执行文件文件路径，szVerb参数接收“open”、“edit”等动作字符串。</td></tr>
<tr class="memberitemodd"><td>CheckFileOpened<div class="methodparam">参数1:szFilePath(文本)</div><div class="methodparam">返回:布尔</div></td><td>检查指定的文件是否已经被打开，如果被打开则把打开它的程序窗口设置为活动窗口。</td></tr>
<tr class="memberitemeven"><td>GetAppDataFolder<div class="methodparam">返回:文本</div></td><td>返回当前用户的应用程序数据目录，如：C:\\Documents and Settings\\<当前登录windows的用户名>\\Application Data\\</td></tr>
<tr class="memberitemodd"><td>GetLocalAppDataFolder<div class="methodparam">返回:文本</div></td><td>返回当前用户的本地（非漫游）应用程序数据目录，如：C:\\Documents and Settings\<当前登录windows的用户名>\\Local Settings\\Application Data\\</td></tr>
<tr class="memberitemeven"><td>GetScreenWidth<div class="methodparam">返回:整数</div></td><td>获取屏幕横向（x轴）分辨率（单位像素）。</td></tr>
<tr class="memberitemodd"><td>GetScreenHeight<div class="methodparam">返回:整数</div></td><td>获取屏幕竖向（y轴）分辨率（单位像素）。</td></tr>
<tr class="memberitemeven"><td>GetFileIcon<div class="methodparam">参数1:szFile(文本)</div><div class="methodparam">返回:文本</div></td><td>根据文件扩展名提取并返回本地图标文件路径。</td></tr>
<tr class="memberitemodd"><td>GetFileMD5<div class="methodparam">参数1:szFilePath(文本)</div><div class="methodparam">返回:文本</div></td><td>根据完整文件名获取其文件内容MD5结果。</td></tr>
<tr class="memberitemeven"><td>AddEventLog<div class="methodparam">参数1:szMsg(文本)</div><div class="methodparam">参数2:szSource(文本),默认值:腾硕协作应用构建平台</div><div class="methodparam">参数3:iType(整数),默认值:0</div></td><td>记录消息到系统事件日志，szMsg表示消息内容；szSource表示事件源，默认为“腾硕协作平台”；iType表示日志类型，0表示消息、1表示警告、2表示错误。</td></tr>
<tr class="memberitemodd"><td>EnumFilesSize<div class="methodparam">参数1:szDir(文本)</div><div class="methodparam">返回:无符号整数</div></td><td>递归获取szDir指定的目录下的所有文件的大小（包含子目录下的文件），单个文件大小或总大小均不能超过4GB。</td></tr>
<tr class="memberitemeven"><td>EnumFilesCount<div class="methodparam">参数1:szDir(文本)</div><div class="methodparam">返回:无符号整数</div></td><td>递归获取szDir指定的目录下的所有文件的个数（包含子目录下的文件）。</td></tr>
<tr class="memberitemodd"><td>EnumFiles<div class="methodparam">参数1:szDir(文本)</div><div class="methodparam">返回:文本</div></td><td>递归获取szDir指定的目录下的所有文件并返回这些文件，返回目录下的所有文件列表（包含子目录下的文件），多值用半角分号分隔，每个子目录下的第一个文件带相对于szDir的路径信息，否则只有文件名。</td></tr>
<tr class="memberitemeven"><td>GetLocalIPAddress<div class="methodparam">返回:文本</div></td><td>获取本机IP地址信息，多个地址用半角分号分隔。</td></tr>
<tr class="memberitemodd"><td>ReadText<div class="methodparam">参数1:szText(文本)</div></td><td>朗读传入的文本。</td></tr>
</table>
</body>
</html>